add brief explanation of how to use GtkOptionMenu

2001-12-01  Havoc Pennington  <hp@pobox.com>

	* gtk/tmpl/gtkoptionmenu.sgml: add brief explanation of how to use
	GtkOptionMenu

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 254f3da867bfc269cc4a551d41fc4cdb69cad38e..5b2ffc0ca2b49e644939fad5b013549c6cbb1e62 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2001-12-01  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/tmpl/gtkoptionmenu.sgml: add brief explanation of how to use
+       GtkOptionMenu
+
 2001-11-30  Matthias Clasen  <matthiasc@poet.de>
 
        * gdk/tmpl/colors.sgml, gdk/tmpl/pixmaps.sgml, gdk/tmpl/dnd.sgml,

diff --git a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
index 3c537677185a33dc90f2332f5d9d2638350bc2f6..7ce82020920571cd270f4645f8dcda7eb16d3d84 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
@@ -12,6 +12,16 @@ choice.  When activated the #GtkOptionMenu displays a popup #GtkMenu
 which allows the user to make a new choice.
 </para>
 
+<para>
+Using a #GtkOptionMenu is simple; build a #GtkMenu, by calling
+gtk_menu_new(), then appending menu items to it with 
+gtk_menu_shell_append(). Set that menu on the option menu 
+with gtk_option_menu_set_menu(). Set the selected menu item with
+gtk_option_menu_set_history(); connect to the "changed" signal on
+the option menu; in the "changed" signal, check the new selected 
+menu item with gtk_option_menu_get_history().
+</para>
+
 <!-- ##### SECTION See_Also ##### -->